home *** CD-ROM | disk | FTP | other *** search
/ By Popular Request 2.0 / By Popular Request 2.0 (Arsenal Computer).ISO / amiga_3 / headtl11.ads < prev    next >
Text File  |  1995-07-23  |  5KB  |  145 lines
  1. Short:    Show first/last n lines/chars of a file.
  2. Author:   D. Chapman/Dan Cannon <dan@blender.demon.co.uk>
  3. Uploader: Dan Cannon <dan@blender.demon.co.uk>
  4. Type:     util/cli
  5.  
  6. This is an update to headtail.lha, written by D. Chapman. It was going wrong
  7. sometimes, I changed it to work with longer lines. While I was at it, I made
  8. it so that the file name can be case insensitive (eg. you can call it head,
  9. Head, tail, TAIL, etc...) because it checks its own file name to work out
  10. whether you want head or tail.
  11.  
  12. Anyway, copy HeadTail to C:Head and C:Tail and you're sorted.
  13.  
  14. Dan.
  15.  
  16. ----- Original Read Me -----
  17.  
  18. Short: unix-style head/tail, better than others
  19.  
  20. Well, yes, they are, to be honest.  I haven't yet seen a "head" or
  21. "tail" program for AmigaDOS which even implemented the lbc stuff in
  22. the "real" tail for Unix.  Though numerous, all the tails I've seen
  23. can only do lines, with one exception that could do chars.  This last,
  24. however, couldn't read from standard input.  I found my work severely
  25. limited; I maintain that head and tail are among the most useful tools
  26. in the unix environment.
  27.  
  28. So here's a tail program that reads any number of files, or standard
  29. input; if more than one file is read, the start of each file is noted
  30. in stderr, with files sections themselves going to stdout.  Unlike
  31. most other Amiga tails I've seen, headtail can do head-relative or
  32. tail-relative tailing by using "+" or "-" before the count.  E.g., for
  33. the file:
  34.  
  35. Start
  36. Line1
  37. Line2
  38.  
  39. Line4
  40. End
  41.  
  42. > tail +3l <file>
  43.  
  44. would report:
  45. Line2
  46.  
  47. Line4
  48. End
  49.  
  50. while
  51.  
  52. > tail -3l <file>
  53.  
  54. would report:
  55.  
  56. Line4
  57. End
  58.  
  59. You see?
  60.  
  61. Character units (specifiec with "c" in place of "l") work similarly;
  62.  
  63. > tail -7 <file>
  64.  
  65. on the above example file would return:
  66. e4
  67. End
  68.  
  69. (You must remember to count line feeds.)
  70.  
  71. Blocks work the same way; a block is equivalent to 512 characters.
  72. You can change this in the source code to 488 if you use an OFS
  73. system; it will more accurately reflect your actual file structure.
  74.  
  75.  
  76.  
  77. AND, AS AN ADDED BONUS:
  78.  
  79. The Unix "head" is included, too.  Soaring above even Unix head,
  80. however, headtail's head will take all the same arguments as tail.
  81. The only difference in meaning is that "+" and "-" swap places; i.e,
  82.  
  83. Program    Sign    Meaning
  84. tail    +    count is relative to start of file
  85. tail    -    count is relative to end of file
  86. head    +    count is relative to end of file
  87. head    -    count is relative to start of file
  88.  
  89. Thus Unix-formatted commands work with headtail, but there are more
  90. option if you want them.
  91.  
  92.  
  93.  
  94. BUT WAIT -- THERE'S EVEN MORE!
  95.  
  96. As a special for Kickstart v36+ users, head and tail are included as
  97. one program.  It works like compress: there's one program, and its
  98. function is determined by its name.  Basic installation consists of
  99. copying tail to somewhere in your path, and making a link from "head"
  100. to "tail".  (You could, of course, do it the other way.)  If called as
  101. "head", the program performs head stuff; if called as "tail", it does
  102. tail stuff.  If called something else, it still does tail stuff.
  103.  
  104. If you don't have 2.0, you should.  But you can still use headtail by
  105. just copying the program to "head", then to "tail".  They don't have
  106. to be links, but it saves disk space if they are.
  107.  
  108.  
  109.  
  110. HeadTail was written by David Champion some time in July - August
  111. 1992.  It was compiled with Matt Dillon's DICE, and the source code is
  112. geared toward that compiler.  SAS users will have to perform surgery
  113. to make it work, I know.  I tried and gave up becasue I hate SAS
  114. anyway.  Aztec users might have to do cosmetic stuff.  GCC works fine;
  115. just be sure you've either #defined of -D-defined GCC.
  116.  
  117. This stuff, binary and source, is public domain.  I release all
  118. liability for damages brought about by usage at just the wrong time of
  119. day in La Paz, or whatever else could cause a problem, along with
  120. rights to the code.  It's everyone's now.
  121.  
  122. ------------------------------------------------------------
  123.                  Amiga Distribution System
  124. ------------------------------------------------------------
  125.  
  126.                         ADS Zone: 1
  127.                   ADS Hatch Site: Don Plesky
  128.               ADS Position: ADS Zone 1 Coordinator
  129.                  BBS Name: EastPointe Amiga BBS
  130.                  Phone Number(s): 810-773-6959
  131.                  Network Address: 1:120/229  
  132.                      Network Region: 11    
  133.                    BBS Hours: 24 Hrs/Day
  134.            BBS Mailer/Software: DLG Trapdoor/PDQmail
  135.                    BBS Storage Space: 2 Gig 
  136.                File Requestable :  <X> Y     < > N
  137.                File Request Hours : All The Time
  138.  
  139.  
  140.  
  141. ---------------------------------------------------------------
  142. Help the Amiga! Join the ADS team Become a ADS Hub<=>Freq ADSINFO 
  143. ---------------------------------------------------------------
  144.  
  145.